이름¶

getpwent, setpwent, endpwent - 패스워드 파일 엔트리를 가져온다.

사용법¶

#include <pwd.h>
#include <sys/types.h>

struct passwd *getpwent(void);

void setpwent(void);

void endpwent(void);

설명¶

getpwent() 함수는 /etc/passwd에서 뽑아낸 라인 필드들을 포함하는 구조체에 대한 포인터를 반환한다. 함수를 처음 호출하면 이 함수는 처음 엔트리를 반환한다;그후, 이 함수는 연속적인 엔트리를 반환한다.

setpwent() 함수는 파일 포인터를 /etc/passwd 파일의 시작으로 되 돌린다.

endpwent() 함수는 /etc/passwd 파일을 감는다.

passwd 구조체는 다음처럼 <pwd.h>에 정의되어 있다:

struct passwd {


        char    *pw_name;		/* 유저 이름 */


        char    *pw_passwd;		/* 유저 패스워드 */


        uid_t   pw_uid;			/* 유저 id */


        gid_t   pw_gid;			/* 그룹 id */


        char    *pw_gecos;      	/* 실제 이름 */


        char    *pw_dir;  		/* 홈 디렉토리 */


        char    *pw_shell;      	/* shell 프로그램 */
};

반환값¶

getpwent() 함수는 passwd 구조체를 반환하거나, 만일 더이상 엔트리가 없거나 에러가 발생한다면 NULL을 반환한다.

에러¶

ENOMEM

패스워드 구조체를 할당할 메모리가 충분하지 않다.

파일¶

/etc/passwd

패스워드 데이터 베이스 파일

호환¶

SVID 3, BSD 4.3

관련 항목¶

fgetpwent(3), getpwnam(3), getpwuid(3), getpw(3), putpwent(3), passwd(5).

역자¶

정강훈 <skyeyes@soback.kornet.net>, 2001년 4월 30일